Blockquotes

Blockquotes are unique block-level elements that can contain other block-level elements. They have a diverse set of usages due to this, such as capturing a sequence of conversation, or being a container for an important presentation of concepts.

Syntax

Blockquotes are created by starting a line with the > character. A space between text content and the > character is optional, but recommended. Any Markdown or Markdown++ convention is acceptable as text content inside of Blockquotes.

Basics

A basic Blockquote containing a single Paragraph

> A paragraph inside a blockquote.

Markdown In Blockquotes

Other Markdown elements, like headings and lists, can be used inside Blockquotes. Use the same spacing and indentation rules as usual when inside Blockquotes.

> ### How to Publish Content with ePublisher
> 
> Here's some steps to publish your content with ePublisher.
> 
> 1. Open ePublisher
> 2. Add source documents
> 3. Select Format
> 4. Click **Generate All**

Nested Blockquotes

Other Blockquotes can also be nested inside of Blockquotes, and so on.

> First level blockquote
> 
> > Second level nested blockquote.
> > 
> > > Third level nested blockquote.
> > > 

Markdown++

A custom Paragraph Style can be given to a Blockquote using a Markdown++ style: command on the line directly above the Blockquote.

<!--style:CustomBlockquote-->
> A customized blockquote, style name "CustomBlockquote"

Customizing Nested Blockquotes

Nested Blockquotes can be customized as well.

> A default blockquote, style name "Blockquote"
> 
> <!--style:CustomBlockquote-->
> > A customized blockquote, style name "CustomBlockquote"
> > 

Default Until Customized

Nested Blockquotes are treated as standalone; they will not inherit the outermost stylename if customized.

<!--style:CustomBlockquote-->
> A customized blockquote, style name "CustomBlockquote"
> 
> > A default blockquote, style name "Blockquote"
> > 

Add a style: command to each blockquote individually for consistency with custom styles.

<!--style:CustomBlockquote-->
> A customized blockquote, style name "CustomBlockquote"
> 
> <!--style:CustomBlockquote-->
> > A customized blockquote, style name "CustomBlockquote"
> > 

Markdown in Blockquotes

The tagging convention can be used for other Markdown elements inside Blockquotes. These style names will inherit the Blockquote's style name as a prefix. See Nested Styles for more info.

> <!--style:CustomParagraph-->
> A customized paragraph, style name "Blockquote CustomParagraph"
> 
> <!--style:CustomList-->
> - an unordered list
> - customized
> - style name "Blockquote CustomList"
> 

To learn more about Markdown++ tagging, see Learning Markdown++.

ePublisher Style Information

Style Behavior

Blockquotes are considered containers; they contain other block-level elements, like Paragraphs, Lists, and Tables. Because of this, ePublisher creates a number of different styles when it detects blockquotes in source documents.

Blockquote Style

The Blockquote Style is the first style that ePublisher adds to the Style Designer when a blockquote is detected in a source document. The default name is Blockquote, but could also be a custom name if the style: command is used on the blockquote.

This style applies to the container area surrounding the blockquote's content. It's style rules can also apply to nested content, if the same rule isn't already applied on the nested style.

Customizing the Blockquote Style

By adding a Markdown++ custom style: command, the Blockquote Style name can be changed. The example below changes the Blockquote Style name to CustomBlockquote:

<!--style:CustomBlockquote-->
> This is a custom named blockquote.
>

Nested Styles

Nested content inside of Blockquotes also get a new style name. To determine the Nested Style's name, take the Blockquote Style and add the style name of the nested content to the end, separated by a space.

The example below populates the Style Designer with 3 Paragraph Styles: Blockquote (the Blockquote Style), Blockquote Heading 1, and Blockquote Paragraph when scanned into ePublisher.

> # Heading 1 element inside a blockquote
> 
> This is a Paragraph element inside of a blockquote.
> 

Customizing Nested Styles

By adding a Markdown++ custom style: command, the Nested Style name can be changed. The example below changes the Nested Style name to Blockquote CustomParagraph:

> <!--style:CustomParagraph-->
> This is a custom paragraph.
>

Custom Style Names can be used on both the blockquote and nested content simultaneously. This example creates the style names CustomBQ, and CustomBQ CustomParagraph:

<!--style:CustomBQ-->
> <!--style:CustomParagraph-->
> This is a custom paragraph inside a blockquote.
> 

Default Style Properties

Style Type: Paragraph
Style Name: Blockquote

If a custom style name is assigned to a Blockquote, that style name will still inherit all of the listed default style information.